<html>
<head><meta charset="utf-8"><title>tool to keep docs up to date · t-compiler · Zulip Chat Archive</title></head>
<h2>Stream: <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/index.html">t-compiler</a></h2>
<h3>Topic: <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html">tool to keep docs up to date</a></h3>

<hr>

<base href="https://rust-lang.zulipchat.com">

<head><link href="https://rust-lang.github.io/zulip_archive/style.css" rel="stylesheet"></head>

<a name="214121191"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214121191" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214121191">(Oct 21 2020 at 22:08)</a>:</h4>
<p>I'm thinking of trying to build a tool that helps keep docs up to date. Library docs are relatively easy to keep up to date since they are inline rustdocs. Compiler API docs can also be done inline. But there are things like the rustc-dev-guide and forge that are <em>not</em> inline -- also the unstable book, rustdoc book, etc.</p>



<a name="214121287"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214121287" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Léo Lanteri Thauvin <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214121287">(Oct 21 2020 at 22:09)</a>:</h4>
<p>For now I think we have two main ways of doing this: MCPs and linkchecking API docs</p>



<a name="214121297"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214121297" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214121297">(Oct 21 2020 at 22:09)</a>:</h4>
<p>My idea is that we have each piece of documentation have a special HTML comment like <code>&lt;!-- doc-for: &lt;some-feature-name&gt; --&gt;</code> in each of those places. Then a tool can go through all the know doc places (<code>src/doc</code>, <code>rustc-dev-guide</code>, <code>forge</code>) and print out the locations that may need updating</p>



<a name="214121577"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214121577" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214121577">(Oct 21 2020 at 22:12)</a>:</h4>
<p>E.g. this would prevent the need for follow-up PRs like this one: <a href="https://github.com/rust-lang/rust/issues/77295">#77295</a></p>



<a name="214121624"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214121624" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214121624">(Oct 21 2020 at 22:12)</a>:</h4>
<p>I at least wanted to float the idea :)</p>



<a name="214121790"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214121790" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Léo Lanteri Thauvin <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214121790">(Oct 21 2020 at 22:14)</a>:</h4>
<p>Let's cc <span class="user-mention" data-user-id="232545">@Joshua Nelson</span> <span class="user-mention" data-user-id="281757">@Jubilee</span></p>



<a name="214121840"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214121840" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214121840">(Oct 21 2020 at 22:15)</a>:</h4>
<p>(let me finish up my mess in <a href="#narrow/stream/196385-t-compiler.2Fwg-rustc-dev-guide/topic/check-in/near/214119844">https://rust-lang.zulipchat.com/#narrow/stream/196385-t-compiler.2Fwg-rustc-dev-guide/topic/check-in/near/214119844</a> first)</p>



<a name="214123236"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214123236" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214123236">(Oct 21 2020 at 22:31)</a>:</h4>
<p><span class="user-mention silent" data-user-id="307537">Camelid</span> <a href="#narrow/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date/near/214121297">said</a>:</p>
<blockquote>
<p>My idea is that we have each piece of documentation have a special HTML comment like <code>&lt;!-- doc-for: &lt;some-feature-name&gt; --&gt;</code> in each of those places. Then a tool can go through all the know doc places (<code>src/doc</code>, <code>rustc-dev-guide</code>, <code>forge</code>) and print out the locations that may need updating</p>
</blockquote>
<p>hmm ... how would you keep the <code>doc-for</code> comment itself in sync with the dev-guide?</p>



<a name="214123333"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214123333" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214123333">(Oct 21 2020 at 22:32)</a>:</h4>
<p>you'd need everyone making changes to know about it and know to update it</p>



<a name="214123355"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214123355" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214123355">(Oct 21 2020 at 22:32)</a>:</h4>
<p>I guess my main hesitation is I want to avoid at all costs forcing you to clone rust-lang/rust to update the dev guide</p>



<a name="214123385"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214123385" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214123385">(Oct 21 2020 at 22:33)</a>:</h4>
<p>the build process for rust is bad enough without it spilling over to the docs</p>



<a name="214123731"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214123731" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Léo Lanteri Thauvin <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214123731">(Oct 21 2020 at 22:36)</a>:</h4>
<p><span class="user-mention silent" data-user-id="232545">Joshua Nelson</span> <a href="#narrow/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date/near/214123355">said</a>:</p>
<blockquote>
<p>I guess my main hesitation is I want to avoid at all costs forcing you to clone rust-lang/rust to update the dev guide</p>
</blockquote>
<p>I think that was already out of the question :D<br>
As I understand <span class="user-mention silent" data-user-id="307537">Camelid</span>'s idea, every time a PR gets merged, a bot can suggest to update the documentation</p>



<a name="214124411"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214124411" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214124411">(Oct 21 2020 at 22:45)</a>:</h4>
<p>Yes, that's one possible implementation.</p>



<a name="214124571"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214124571" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214124571">(Oct 21 2020 at 22:47)</a>:</h4>
<p>Here's an example of how it would look for <code>asm!</code>:</p>
<ul>
<li>unstable book has an HTML comment in the section on <code>asm!</code> that looks like: <code>&lt;!-- doc-for: inline_asm --&gt;</code></li>
<li>compiler code has the comment <code>// doc-item: inline_asm</code> for every place there is <code>asm!</code> code</li>
</ul>



<a name="214124617"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214124617" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214124617">(Oct 21 2020 at 22:48)</a>:</h4>
<p>Probably would be too much work, but maybe there's something smaller we can do</p>



<a name="214125145"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214125145" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214125145">(Oct 21 2020 at 22:54)</a>:</h4>
<p>rustdoc does this just with review, 'new lints require you to update <code>src/doc/rustdoc</code>'</p>



<a name="214125155"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214125155" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214125155">(Oct 21 2020 at 22:54)</a>:</h4>
<p>probably could make that a tidy lint</p>



<a name="214125169"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214125169" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214125169">(Oct 21 2020 at 22:55)</a>:</h4>
<p>it's harder for the dev-guide because it's in a different repo</p>



<a name="214125199"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214125199" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214125199">(Oct 21 2020 at 22:55)</a>:</h4>
<p>I think we should start by doing this for things in-tree, like the unstable-book, and then if it works well we can think of a way to make it work across repos</p>



<a name="214125478"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214125478" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214125478">(Oct 21 2020 at 22:58)</a>:</h4>
<p><span class="user-mention silent" data-user-id="232545">Joshua Nelson</span> <a href="#narrow/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date/near/214125145">said</a>:</p>
<blockquote>
<p>rustdoc does this just with review, 'new lints require you to update <code>src/doc/rustdoc</code>'</p>
</blockquote>
<p>Hm, could you link to an example?</p>



<a name="214125507"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214125507" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214125507">(Oct 21 2020 at 22:59)</a>:</h4>
<p>That also doesn't catch things like my intra-doc link generics PR</p>



<a name="214125620"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214125620" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214125620">(Oct 21 2020 at 23:00)</a>:</h4>
<p>sure</p>



<a name="214125629"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214125629" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214125629">(Oct 21 2020 at 23:00)</a>:</h4>
<p>I don't think we can catch the <em>general</em> case of 'something in the compiler has a user-visible impact'</p>



<a name="214125668"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214125668" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214125668">(Oct 21 2020 at 23:00)</a>:</h4>
<p><a href="https://github.com/rust-lang/rust/pull/77856">https://github.com/rust-lang/rust/pull/77856</a></p>



<a name="214125676"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214125676" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214125676">(Oct 21 2020 at 23:01)</a>:</h4>
<p>What I'm suggesting is less "check to make sure someone updated the docs" and more "give someone the ability to see all the places this is documented"</p>



<a name="214125713"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214125713" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214125713">(Oct 21 2020 at 23:01)</a>:</h4>
<p>well, those are basically the same - the only difference is whether 'look at the places this is documented' is automated or done by the author</p>



<a name="214125758"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214125758" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214125758">(Oct 21 2020 at 23:02)</a>:</h4>
<p>but figuring out where it's documented in the first place seems like the hard part</p>



<a name="214125802"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214125802" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214125802">(Oct 21 2020 at 23:02)</a>:</h4>
<p><span class="user-mention silent" data-user-id="232545">Joshua Nelson</span> <a href="#narrow/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date/near/214125668">said</a>:</p>
<blockquote>
<p><a href="https://github.com/rust-lang/rust/pull/77856">https://github.com/rust-lang/rust/pull/77856</a></p>
</blockquote>
<p>Huh, where is the automated check?</p>



<a name="214125819"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214125819" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214125819">(Oct 21 2020 at 23:03)</a>:</h4>
<p>there is no automated check, that's what I meant by 'with review'</p>



<a name="214125849"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214125849" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214125849">(Oct 21 2020 at 23:03)</a>:</h4>
<p>but it could be automated I think, the check is 'new file added to <code>src/librustdoc/passes</code> without updating <code>src/doc/librustdoc</code>'</p>



<a name="214125903"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214125903" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214125903">(Oct 21 2020 at 23:04)</a>:</h4>
<p>obviously not that simple for other parts of the compiler</p>



<a name="214126237"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214126237" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214126237">(Oct 21 2020 at 23:08)</a>:</h4>
<p>Well, for unstable features it might be almost that simple: 'new feature gates added not in unstable-book'</p>



<a name="214126346"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214126346" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214126346">(Oct 21 2020 at 23:10)</a>:</h4>
<p>I think we should nibble at this a little at a time instead of trying to get a fully general solution, because the fully-general solution isn't possible without you specifying the dependencies yourself and I really hate that in build systems</p>



<a name="214127399"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214127399" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214127399">(Oct 21 2020 at 23:28)</a>:</h4>
<p>Sounds like a plan!</p>



<a name="214127641"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214127641" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214127641">(Oct 21 2020 at 23:32)</a>:</h4>
<p>I'll open an issue</p>



<a name="214129852"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214129852" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214129852">(Oct 22 2020 at 00:02)</a>:</h4>
<p>Opened <a href="https://github.com/rust-lang/rust/issues/78211">#78211</a></p>



<a name="214162059"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214162059" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Vadim Petrochenkov <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214162059">(Oct 22 2020 at 09:23)</a>:</h4>
<p>I think dev-guide and co need to be migrated from a submodule to a subtree first of all.</p>



<a name="214162105"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214162105" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Vadim Petrochenkov <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214162105">(Oct 22 2020 at 09:23)</a>:</h4>
<p>Right now I never bother to update dev-guide when making compiler changes because it lives in a separate repo.</p>



<a name="214179452"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214179452" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214179452">(Oct 22 2020 at 12:30)</a>:</h4>
<p>Are the fixes to <code>git subtree</code> still stuck in limbo? :/</p>



<a name="214179695"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/tool%20to%20keep%20docs%20up%20to%20date/near/214179695" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> bjorn3 <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/tool.20to.20keep.20docs.20up.20to.20date.html#214179695">(Oct 22 2020 at 12:32)</a>:</h4>
<p>There have been a several review comments.</p>



<hr><p>Last updated: Aug 07 2021 at 22:04 UTC</p>
</html>